What is this strategy?
This strategy focuses on using reference materials in your Playlab app to improve its knowledge base. By uploading documents or adding links, you can give your app access to specific information that helps it generate more accurate, relevant, and customized responses for your users.Think of references as giving your Playlab app a specialized library of knowledge that it can draw from when answering questions.
Why It’s Important
References are key to building apps that have specialized knowledge beyond what the AI already knows:- Ensures responses align with specific, verified information
- Tailors content to your exact curriculum or teaching standards
- Provides rich context for more comprehensive answers
- Allows incorporation of up-to-date information through external links
- Enables creation of school-specific or organizational content
How to Add References
Prepare Your Reference Materials
Choose the Right Format:
- PDFs work well for maintaining formatting
- Markdown for structured text
- Well-organized text files
- Links to external resources
- Break large documents into smaller, focused files
- Ensure clear formatting for easier AI parsing
- Tables and structured formats are easier for the AI to understand than long paragraphs
Upload References in Playlab
While in the Playlab app builder:
- Navigate to the References section
- Click “Upload” to add document files or “Add Link” for web resources
- Give each reference a descriptive name
- Make sure you have permission to upload the references.
Guide Your App to Use References
In your app instructions, specify how and when to use the references:Example Instructions:
- “Use the lesson plan document to create activities that align with our school’s 4th-grade science curriculum.”
- “When answering questions about classroom management, refer to the discipline policy document.”
- “Based on the provided state standards document, generate grade-appropriate math exercises.”
Reference Use Case Examples
Educational Applications with References
| Use Case | Reference Type | Example Instruction |
|---|---|---|
| Curriculum Planning | Syllabus documents, standards PDFs | ”Using the attached curriculum standards, create a weekly lesson plan for 2nd-grade math on addition and subtraction.” |
| Assessment Creation | Previous exams, rubrics | ”Based on the sample tests provided, generate 5 new assessment questions on photosynthesis that match our difficulty level.” |
| Differentiated Learning | Student data, learning profiles | ”Referring to the learning styles document, adapt this history lesson on Ancient Egypt for visual, auditory, and kinesthetic learners.” |
| Feedback Generation | Feedback guidelines, student work samples | ”Using our feedback rubric, provide constructive comments on this student’s essay about ‘To Kill a Mockingbird’.” |
| Parent Communication | Communication templates, school policies | ”Based on our communication guide, draft an email to parents about the upcoming science fair that includes all required information.” |
Key Implementation Strategies
Choose Quality References
Choose Quality References
- Select authoritative, accurate, and relevant materials
- Focus on resources that directly support your app’s purpose
- Consider the credibility and currency of information
- For educational apps, use official curriculum documents, textbooks, or verified teaching resources
Be Explicit in Your Instructions
Be Explicit in Your Instructions
- Clearly direct the app to use specific references for specific tasks
- Example: “When creating vocabulary exercises, refer to the word list document”
- Specify which sections of longer documents are relevant for particular questions
- Tell the app how to prioritize different references when they contain overlapping information
Combine Reference Types for Better Results
Combine Reference Types for Better Results
- Mix document types for comprehensive coverage
- Example: Combine curriculum standards, lesson plan templates, and content resources
- Use structured references (tables, lists) alongside narrative content
- Include both broad overview documents and detailed specific resources
Regularly Update Your References
Regularly Update Your References
- Review and refresh materials to ensure accuracy
- Update seasonal or time-sensitive content
- Replace outdated information with current resources
- Add new references as curriculum or requirements change
Frequently Asked Questions
How many references should I include?
How many references should I include?
Start with 3-5 core references that cover your app’s main functionality. Quality is more important than quantity - each reference should serve a clear purpose. Too many references can actually make it harder for the app to focus on the most relevant information.
What file formats work best for references?
What file formats work best for references?
PDFs, markdown files, and well-structured text documents work well. For tabular data, CSV files or documents with clear tables are ideal. The AI can parse most common formats, but clearer structure helps it understand the content better.
Should I test my app with and without references?
Should I test my app with and without references?
Yes! Toggle the reference setting on and off to see how it impacts your results. This helps you determine if your references are actually improving the outputs or if they might be confusing the app.
How do I know if my references are being used effectively?
How do I know if my references are being used effectively?
Look for specific information from your references appearing in the app’s outputs. The responses should be more specific, accurate, and aligned with your provided materials. If you don’t see evidence that the references are being used, try adjusting your instructions to more explicitly direct the app to use them.
Need Support?
Have you created an app using references? We’d love to hear about your experience!Contact us at support@playlab.ai